home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
The Original Shareware 1.1
/
The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso
/
16
/
wputil.zip
/
XWORD.DOC
< prev
next >
Wrap
Text File
|
1986-03-30
|
11KB
|
235 lines
X W O R D D O C U M E N T A T I O N
By Ronald Gans
350 West 55th Street #2-E
New York, New York 10019
(See the end of this file for registration information)
INTRODUCTION Page 1
What You Should Have and What Is Required
There should be two files ARC'd together: XWORD.EXE and XWORD.DOC. The
ARC'd file will be called XWORDnnn.ARC; the 'nnn' refers to the revision
number of XWORD.EXE. The only file that is essential to XWORD's
operation is XWORD.EXE. XWORD should work OK on any IBM PC (IBM PC-XT,
IBM PC-AT, or close compatible, such as the COMPAQ or AT&T 6300).
XWORD.EXE requires about 80K bytes of memory and will only work with DOS
2.xx or above. XWORD.EXE senses whether the monitor is monochrome or
color, but in either case writes directly to the screen in the normal
video mode. This file, XWORD.DOC, should clarify difficult points of
XWORD's operation. See the end of this file for more information about
registration and copyright.
XWORD is a general file format transformer; that is, it converts files from
one format to another. Selections are made from two menus, "FORMAT
CONVERTERS" and "LOGICAL OPTIONS." Since XWORD is not tricky to use, this
file deals with general operation procedures, some problems, and what XWORD
does not do.
I have made some arbitrary decisions regarding what XWORD does to files.
Sometimes it is not possible, or not possible without great difficulty, to
preserve print options between different word processing formats. In some of
these cases, I have elected to eliminate them and let the user re-input them
anew. For those word processors which require a line length embedded in the
files, I have chosen one arbitrarily, based on my own experience.
XWORD appends a 1AH to the ends of files under certain options. Those
options that convert files to ASCII format all append a 1AH to the file.
This is not required for MS/PC-DOS, but it necessary in CP/M, to which ASCII
files can be ported.
WILDCARDS, DRIVES, and SUBDIRECTORIES
XWORD supports wildcards (* and ?) in the source file name. When wildcards
are used, XWORD will overwrite the source file (a warning to that effect
appears). YOU STRONGLY ADVISED TO MAKE ALL CONVERSIONS ON COPIES OF FILES
ONLY, NEVER ON THE ORIGINALS. XWORD also fully supports drives and
subdirectories in both the source and target file names.
Page 2
MENU ONE
REDUCING SPACES
Use only with ASCII or WordStar-compatible files. DO NOT USE WITH MULTIMATE
FILES OR WITH WORDSTAR 2000 FILES. You will have to reboot if you try to
load a file processed with the P option into Multimate or WordStar 2000.
WORDSTAR, WORDSTAR 2000, AND SIDEKICK
No special precautions need be taken regarding these files. Both WordStar
and WordStar 2000 will allow any kind of file name. There is still a problem
with tab handling (by XWORD), but the rest of the options of the two should
be OK. XWORD will support WordStar 2000's JUSTIFY.FRM, RAGGED.FRM, MEMO.FRM,
and NORMAL.FRM. It will not support the NOFORM.FRM. This format is
identical to ASCII. Thus, if converting a file produced with WordStar 2000
and NOFORM.FRM, select ASCII as the source file format.
Sidekick is compatible with WordStar, BUT, the tabs of files written in
WordStar's non-document mode show up as capital "I"s in Sidekick. XWORD
expands expands these tabs so they will appear properly.
If your file in WordStar2000 looks funny when XWORD is through with it, place
the cursor at the beginning of the paragraph and press any letter (you will
have to erase the letter you input). This will cause WordStar2000 to
reformat the paragraph.
MULTIMATE
XWORD supports conversion into and out of MultiMate. When converting from
WordStar, be careful of indents. Make sure that indents begin after a hard
return or ^PM (equivalent to 0DH). MultiMate requires all document files
have the extension .DOC; XWORD appends this extension to MultiMate-target
files. You will notice that the converted Multimate file will often have
more indents than it should. This is due to the algorithm I used; a future
version of XWORD will solve this problem. I have used XWORD to convert files
longer than 42K to MultiMate with no problems. Converting into MultiMate with
wildcards is the only instance in which wildcard use does not result in the
original files being overwritten, unless they, too, have a .DOC extension.
When converting OUT of MultiMate, it is strongly advised that you
repaginate your document. Multi
Page 3
XYWRITE II PLUS
No special precautions need be taken here, as XyWrite II is very friendly.
(XWORD has been tested on Version 1.00.)
WORDPERFECT
No special precautions are needed regarding conversion to or from
WordPerfect.
MENU TWO
The options on this menu are for bit and byte manipulation. Some of them can
be used for a quick and dirty type of cryptography. Three of the options
require the user to input a value in hexadecimal format (digits 0-9 and
letters A-F, which represent our common notion of 10, 11, 12, to 15); they
are: AND, OR, XOR. Another one, NOT, requires no other input from the user
than the source and target file names. ROL and ROR require the user supply a
number between 1 and 7, inclusive.
The action of NOT, ROL and ROR are fully reversable. That is, if NOT
FileA produces FileB, and NOT FileB produces FileC, then FileC is
identical to FileA. ROR (ROtate through Right) and ROL (ROtate through
Left) circulate the eight bits that compose each byte. ROR 1 time
shifts the bits in each bit right once; the rightmost bit is moved to
the leftmost position (this information is merely for the elucidation of
the user; the user does not have to understand the action of these
options in order to use them). ROL 1 acts in the same way, but to the
left. ROR 2 is the same as ROR 1 and then ROR 1 again. If FileA is
processed with ROR 3, say, producing FileB, and FileB is processed using
ROL 3, producing FileC, then FileC is identical to FileA. You can use a
sequence of these options to scramble a file pretty well (but remember
to record your sequence and go through it in reverse to unscramble it).
That is, if your sequence was:
ROR 4, NOT, ROL 3, NOT, ROL 2
then to undo this, you must go:
ROR 2, NOT, ROR 3, NOT, ROL 4
Page 4
REPLACE
The last option on this menu, Replace, is different from the others.
Replace allows the user to replace any text (ASCII) or hexadecimal
string (a string is a sequence of bytes) by any other text or
hexadecimal string. The two strings do not have to both be ASCII or
hex. Additionally, the user can elect to save these strings and reuse
them (especially useful if they were complicated to figure out). The
user will be prompted for a source file and then a target file; then,
whether the string is to be entered in ASCII, hex, or from a previously
saved file. If the user enters a string in ASCII or hex, XWORD will ask
if the user wants to save the string. This sequence is repeated for the
replacement (new) string. Each string can be 30 bytes (characters)
long. When entering hex, note that each hex digit must be composed of
two numerals (including letters). Thus, the string more commonly
written as 0DH,0AH,27H,64H,0FFH, would be enterd as 0D0A2764FF.
Remember that if you Replace a commonly occurring byte in a file with a long
string, then your target file could become up to 30 times as large as the
original file.
If you make an error during hex entry, hit the backspace key, and you will be
reset to the beginning of hex entry. Generally in XWORD, hitting the space
bar, return, or end key lets you escape from one level of the program to
another, and, except when files are actually being converted, control-C
always works.
DISCLAIMERS, OWNERSHIP, COPYRIGHTS
XWORD is the property of Ronald Gans; XWORD is unpublished and copyrighted.
XWORD may not be sold for profit by anyone. If you purchased XWORD for more
than the price of a disk, shipping, and handling, you got taken and should
notify me of that fact, along with the name of the person or corporation from
whom you purchased XWORD. XWORDnnn.ARC, XWORD.EXE, XWORD.DOC, and
XWRDINVC.EXE may be freely copied and distributed, but may not be altered in
any way by anyone. If you wish an alternate version of XWORD, please let me
know. Please direct all correspondence to:
RONALD GANS
350 WEST 55TH STREET
NEW YORK, NEW YORK 10019
CompuServe No. 74216,264 Telephone (212) 957-8361
Page 5
You may make unlimited copies of XWORD.EXE for distribution without charge or
rental, to anyone, ONLY IF XWORD.DOC and XWRDINVC.EXE are included. I urge
you to copy the ARC'd file, XWORDnnn.ARC, so that others may share the
documentation and also have a chance to register their copies.
REGISTRATION
Included with the files XWORD.EXE and XWORD.DOC should be the file
XWRDINVC.EXE. Running this program and answering the two questions will
result in an invoice printed out on your printer (assuming a printer is
attached). If you wish to register your copy of XWORD, please fill out and
mail the invoice form back to me at the above address along with $15.00
(N.Y.S. residents please add 8 1/4% sales tax for $16.24). If you register,
you are entitled to free upgrades for one year (there have been many
revisions of XWORD since it was first released to the public and I am
continually working on it). Additionally, if you wish to continue receiving
upgrades after one year, an additional year will cost only $8.00. Planned
enhancements for XWORD include, of course, more word processing formats
(VolksWriter and Navy DIF, among others) along with a greatly enhanced
replace function allowing for "intelligent" replacement.
WordStar and WordStar 2000 are registerd trademarks of MicroPro International
Corporation. MultiMate is a registered trademark of MultiMate International.
XyWrite II Plus is a registered trademark of XyQuest Inc. Sidekick is a
registered trademark of Borland International. WordPerfect is a registered
trademark of Satellite Software. IBM PC, IBM PC-XT, IBM PC-AT are registered
trademarks of International Business Machines, Inc. AT&T 6300 is a registered
trademark of American Telephone & Telegraph Company. COMPAQ is a registered
trademark of COMPAQ Computer Corporation.